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Editorial 


WELCOME TO ISSUE SEVEN OF PRINT-OUT 


As you may have noticed, there has been a major 
change to Print-Out as now, after six issues, 


a 
regular name no longer features on the front of 


the magazine. Unfortunately, we have had to say 
goodbye to Jonathan Haddack, who has decided to 
leave Print-Out. None of the authors work full- 
time on the magazine but rather do 1t when they 
have the time. And as Jon has been finding that 
other occupations require more and more time in 
recent months, he has decided that he is unable 
to continue writing for Print—Out. Although, at 
present, we have no actual replacement for him, 
we hope that the magazine will run as smoothly! 
We all wish Jon the best of luck in the future. 


We hope that you enjoy this issue of Print—-Out, 
and remember that you can order a copy of Issue 
Bigne-Of Print-Outl in advance = see page oo for 
more details on this & other offers.Please take 
thas oppertunity to fail an- ihe price ques tion= 
naire on page 42 as your opinions and ideas are 


very highly valued. 


If you've any queries or problems with the CPC, 


please write to us at the address below & we'll 
do our best to solve your problem. We quarantee 
that all letters will be answered personally by 
one of the writers of Print—Out. The address is 
the same for all orders. and is printed below: 


PRINT-OUT, 8 Maze Green Road, 
Bishop's Stortford, Herts CM23 2PJ. 


COMPETITION —PA 


TUTORIAL 


hs was mentioned last issue, there have been some major changes to the way 
in which the BASIC programming sections are now arranged and there are a couple 
of further alterations to come. Unfortunately not all of the BASIC articles were 
ready in time for this issue & so we've had to include rather more Machine Code 
items than we would normally. Well. next issue will see the start of several new 


features on BASIC. In the meantime, Beginner's BASIC will carry on Sige 
various commands end ‘Advanced BASIC' will continue its e. vamination of the BASIC 


Cee racing System and Farser.Tnis month, we're going to look ec ue ne command 


& a 
~, Ree en morn |] see ot vost wy yy It a 2 Fonte lh one Uk on Yaar mm la al 
daunting: crespect. The ménmual, 26 2c5 aay Cees way. does nothing to dispel 


this be 


SOUND <chanmel status>.<tone periad>l,<durationol, <volumeol, “volume envelove> 
[,<tone envelope >f.<noise period>JjI1I] 


the things in square brackets. however, are 
€ 


+he SOUND command becomes far more manageabl: 
Lone 


mfess that I am no musician and know 
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Before going any further, 
virtually nothing about composing. melodies, etc!! However, I do know how to get 


the CPC to play something fairly close to music. First, let me explain | what the 
‘channel status' is and why we have it. 

When you have a chord, it involves playing more than one note at a time and 
the CPC uses its channel facility to allow it to do this. On the computer you've 
three channels, labelled A, B and C for reference, and each of these can be told 
to play a different note from each other — they can of course also play the same 
note. It might help to think of the channels as being three separate instruments 
although this is not strictly true (as they are all produced by one sound chip). 
These channels can be linked or separated in different ways but for now, we will 
just consider their straight forward use. Each channel has a number that 1s ass— 
ociated with it, & this number tells the CPC which channel to play the note on. 


This number is the channel status and the values we are looking at are: 
~ 1 Channel A only 2 Channel B only 4 Channel C only 


Thus, to play a note on channel A only, the channel status would be 1. The next 
thing to look at is the ‘tone period’. 


The Tone Period is basically a fancy name for the pitch of the note or, in 
other words, which note it is that we wish to play. The various values, and the 
notes they refer to, are all given in the back of the manual. The reasons as to 
how these particular values are derived are also given but I wouldn't worry toc 
much as all of the information needed is printed in one of the appendices. Just 
bear in mind that the higher the number is, the lower the note produced. 

If we look up the data for ‘Middle C' we find the following infcrmation: 


NOTE FREQUENCY PERTOD RELATIVE ERROR 
C 261.626 178 +O. 046% Middle C 


You can ignore everything except the name of the note (C) and the period (478). 
It's the period number which we have to put in the sound command to produce the 
required note. So, to play Middle C on channel A, type: SOUND 1,478 

The channel number for A is 1, and the period value for Middle C is 478. To get 
International A played, simply change the period value: SOUND 1,284 


That is all there is to the SOUND command in its simplest form. At present. 


o 


it is not very versatile & we would have a hard time trying to produce anything 
vaguely musical. If you listen to any note you will realise that it has several 
characteristics. One of these is its pitch (which we have already covered), the 


others are its loudness (volume) and its length (duration) and these are two of 
the optional parameters of the SOUND command. 


DURATION 


The first optional item that we come to, is the ‘duraticn’ 16 t 
the note. When this is added, the definition of the SOUND command becomes: 


he length of 


SOUND <channel status>,<tone period>l,<duration> 3 

The duration of a note is measured in units which are 1/1@@th of a second long. 
This is all there is to the duration part of the command, and so to play Middle 
C for one second on channel A. we would use: SOUND 1,475, 19 

If we do not specify a ‘duration’, the length of the note is automatically 
assumed to be 20/1@@ths of a second (ie @.2 seconds). However, when we are using 
a volume envelope as well. there are complications. But as we haven't dealt with 
this yet, we'll just forget about it for the time being. 

There is just one other thing to notice concerning the duration command. In 
real music, you often see two of the same notes following each other. The music~ 
ian would play these notes with a short gap in between, in order to distinguish 


them from one another. Unfortunately, the computer does not. If you type in the 
SOUND 1,478,1@@:SOUND 1,478,200 you might expect there 
to be two notes of Middle C played one after another (the first lasting 1 second: 
and the second lasting two seconds). Instead you will get one note lasting three 

To make the distinction between the notes, you need to play a silent 
rest) and this leads us onto the next section, volume. 


following line 


seconds! !!. 
note (ie 4 
The next ge is the note's volume, and this is where things can get a bit 

due mainly to a difference between the 464 and the 6128. On the 464, we 
m the range of @ to 7 (with 7 being the loudest and @, silent). 

we get the same range of volume but with different values 
15 on the 6128, corresponds 


Li Ley 
volume i 
with the 6128 
—~ now @ is silent and 15 is the loudest. Thus volume 


to volume 7 on the 464. 


can have 


However , 


Therefore to play middle C on channel A for 1 second at maximum volume, we 
would use (for the 464): SOUND 1,478, 1900,7 

bane “for” cine: clas) 2 SOUND 1.478,1@@,15 000 
This is further confused when we look at volume ee but don't worry about 
them for the moment. 


problem we had with two notes running into each cther, we 
notes of Middle C with a break in between 
:SOUND 1,478, 200,7 

is being played at volume @, 
short period 
ef playing 


GGlng” bac: tothe 
have the 
we would use: 


solution. To play the two 

SOUND 1,478,190,7:SOUND 1,9,1,@ 
The pitch of the middle note does not matter as it 
and will never be heard. All it does is delay the second note by a 
case 1/1@@th of a second) and thus giving the effect 


Now 


T 


Or time Cin this < 
two separate notes. 

near S20. fGr ais: 1Ssuey, 
and volume envelopes in 


I'll be locking at the various tone 
cated to BASIC sound pro- 
common keywords. 


ton which is ded 
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gramming and Beginner's BASIC wi looking at some more 


DATA PD LIBRARY 
PD provides quality Fublic 
Domein software With orders sent 
out within 24 hours. of receiving. 
Now that's Service: 
Send eae blank tape or disc, 


THE TAPE ADVENTURE COLLECTION 


FOUR great adventures in one 
pack. The adventures, previously 
not released on caSSette are.. 
TSLAND OF CHAOS 


Date 


a SAE 


and 50p for a DATA NEWSLETTER and| 
the DATA STARTER PACK which 
features over 20 programs for you 


to try out. So what are you wWait- 
ing for? Please make cheque/FO 
payable to T.Kingsmill. 
DATA DP dd SRER. 4 

2902 PARK STREET LATE, PARK ST., 
ST, ALBANS, H@RTS aL2 2AQ. 


ALT EN FLAN ET 
LORDS OF MAGIC 
ROVING OF CHAOS 


For the 464/6128 Tape only £4.50 
Send cheque/PO to: T.Kingsmill, 
202 Fark Street Lane, Park St. , 
St. Albans,Herts AL2 2aQ. 


-The Firmware 
WEITAL READING ON M/CODE 


Tt has been quite a while since Amstrad decided to discontinue the Firmware 
Manual for the CPC and few books have been produced to take its place. For those 
of you who have never heard of ‘The Firmware Manual’, here is a brief summary: 

Quite simply. the Firmware Manual is the book about how and why the Amstrad 
works: it's invaluable to any Machine Code programmer or CPC enthusiast. However 
the manual is definitely not for the faint-hearted as it is written in technical 
jargon. Still, the amount of information that it contains is incredible. In its 


many pages it covers topics ranging from ROM expansion to driving the sound chip. 


One of the most important sections is its description of the Firmware Jumpblock, 
which tells you how to correctly use the Machine Code calls. 

Unless you intend to access the lower ROM directly (not a good idea:), any 

program which you write in Machine Code will use these firmware calls and their 
entry and exit conditions are essential. As there are over 20@ of these ‘calls’ 
it is unlikely that you will be able to remember all of the things that need to 
be done before = certain routine is used; and this is where the Firmware Manual 
comes in very useful. 

Now that it has been discomtinued, the best book available is the ‘Amstrad 
Advanced Users Guide’ by Daniel Martin (publisher: Glentop ISBN 1-85181-122-<2). 
However Print-Out intends to provide ancther option. Over the next half a dozen 
issues, we hope to be able to print all of the firmware calls together with the 


entry and exit conditions and a brief description of what 1 does. 


First, here is a summary of what information each entry includes. They all 


appear in the following form:- 


NUMBER ADDRESS to call NAME of the routine 
BRIEF DESCRIPTION - what the routine will do when it is called 
ENTRY CONDITIONS —-— what has to be done before it can be called 


EXIT CONDITIONS ~ what will have happened to the registers wnen 
the routine has finished being executed 
SPECIAL NOTES — this part is not always present 


The exact number of issues that this will take up has not yet been decided, but 
it should give anybody who wishes to progress further with Machine Code enough 
information to do so. So here goes with this mammoth task. 


OOO &BBOO@ KM INITIALISE 
ACTION: This routine will initialise the Key Manager and everything will 
be set up as it is when the computer is first swtiched on. 
ENTRY: No entry conditions 
EXIT: AF,BC,DE,HL will be corrupted; all others preserved 


x 


@@1 &BB@S KM RESET 
ACTION: This resets the Key Manager ‘especially indirections and buffers) 
ENTRY: No entry conditions 
EXIT: AF,BC,DE,HL will be corrupted; all others preserved 


@@2 &BBOS KM WAIT CHAR 
ACTION: Waits for the next character from the keyboard 
ENTRY: No entry conditions 
EXIT: Carry flag is set to true; A holds the character value; flags are 
corrupt; all others preserved 


203 &BBO KM READ CHAR 
ACTION: Tests to see if a character is available from the keyboard 
ENTRY: No entry conditions 
EXIT: If character was available - carry true; A contains character 
OTHERWISE - carry false; A corrupt; ALWAYS - others preserved 


0O4 &BBOC KM CHAR RETURN 
ACTION: Save a character for the next use of KM WAIT CHAR or KM READ CHAR 


ENTRY: A contains the ASCII code of the character to be put back 
Exi Ts All registers preserved 


@@5 &BBOF KM SET EXPAND 
ACTION: Assigns a string to a key-code . 
ENTRY: B holds the key-code; C holds the length of the string; HL contains 
the address of the string 
ExLT: IF OK - carry true; ELSE — carry faise; ALWAYS A,BOC,DE,H. corrupt 


006 &BBi2 KM GET EXPAND 
ACTION: Reads a character from an expanded string of characters 
ENTRY: @ holds an expansion token (a key-code); L holds a character number 
EXIT: IF OK - carry true; @ holds character; ELSE ~ carry false; A corrupt 
ALWAYS -— DE corrupt: all others preserved 


@07 &BBIS KM EXP BUFFER 
ACTION: Set aside a buffer area for character expansion strings 
ENTRY: DE holds the address of buffer; HL holds the length of the buffer 
BALES TF OK - Carry true; ELSE - carry false; ALWAYS A,BC,DE,HL corrupt 


008 &BBIS8 KM WAIT KEY 
ACTION: Waits for a key to be pressed 
ENTRY: No entry conditions 
EXIT: Carry true; A holds character; all other registers preserved 


009 &BBIB KM READ KEY 
ACTION: Test whether a character is available from keyboard; does not wait 
ENTRY: No entry conditions 
BAL S IF available — Carry true, A contains character; ELSE Carry false, 
A corrupt; ALWAYS — other registers preserved 


@1@ &BBIE KM TEST KEY 
ACTION: Test if a particular key (or joystick) is pressed 
ENTRY: A contains the key/ joystick number 
EXIT: IF pressed ~ Zero false; ELSE —- Zero true; ALWAYS - Carry false; A 
and HL corrupt; C holds SHIFT/CTRL status; all others preserved 


@11 &BB2i KM GET STATE 
ACTION: See state of SHIFT LOCK and CAPS LOCK 


ENTRY? No entry conditions 


EXIT: [TL holds &FF then SHIFT LOCK is on; if off, L holds &@0 
If H holds &FF then CAPS LOCK is on; if off, H holds &@@ 


ts) 


— Pomebrew Software — 


MAC AL ia by Alan Scully 


Mac II was a 


some of the budget software which you can buy from the shelves. 
noticeable omissions were the lack of a title screen and music. These apart. 


game was virtually faultless. 


very professional effort and one that I am sure is better than 


In fact the only 
the 


The aim of the game is to travel through each level collecting treasure and 


avoiding the ghosts. In every maze, 


are hidden behind locked doors and so it's neces 
of them on the disc, 


ro 


maze is quite large and with ten 


more of your own, 
Although there 


make 


is no background music, 
up for it. These are truly excellent and are 


there are five treasures to collect but they 


sary to get the keys first. Each 
plus the ability to design 


there is plenty to keep you entertained. 


the multi-colour graphics certainly 
the best I have ever seen in a 


homebrew game. They're crisp and clear and make the game seem full of quality. 


The game can be played with keys 
quite a challenge but I found that it 
immediately. The mazes contain thirty 
ones before. 

The actual layout was 
The only problem with the 
shown at 4 


this made the map vital. 


SCrechs., 


time and you couldn't see where the exits onto the next screen 
Even though the scro 
while to draw at the beginning of each maze.Despite the lack of 


or joystick, & it presents the player with 
was not So difficult thet. PF got: frustrated 


and each level is harder than the 


well thought out and this gave an uncluttered display. 
actual game was that only a small part of the maze was 


were — 
olling was very good, the map took a 


any music. there 


were some sound effects which added to the ee PPer Ss 


There were some ‘extras' which are 
seldom found in full-—price software .One 
of these was a Level Designer: it ought 
to have added to the game's appeal but, 
while it was a very good idea it wasn’t 
terribly well implemented although with 
more thought it could have been so much 
better.The instructions are supplied on 
the disc & could be printed out if req- 


uired.You could also switch the map off. 


as well as altering the number of lives 
to suit your ability. 

The game was good fun and I'm sure 
that many people will enjoy playing 1t. 
This program is available from Scull PD 
(see the article on page 18 for prices/ 
details) 
The address is 119 Laurel Drive, Green- 
hills, East Kilbride, Glasgow G75 9JG. 


so it shouldn't break the bank. 


a ee ee eee ee ee ee ee 


Avoiding the Ghost 


MAC LS fe by Alan Scully . 


Mac III, the second game from Alan for the moment, was again good although 
not nearly as professional as Mac II. Having said this, the game had many points 
of merit. 

Tt is a bit like 'Pac-Man' in style and layout but this time you control a 
small object, called Mac, who has to collect several items from the screen. What 
makes it difficult is that the screens have to be completed in a certain time. 

The game sounds simple in theory but in practice it is really quite tricky. 
Mac has an unusual tendency to bounce off the wall and fly back in the direction 
where he came from. While this made the game more interesting, the response was 
not particularly good - thus making timing difficult. 

Despite this, the actual screens are clear, simple and the graphics, whilst 
net being particularly detailed, were varied and were good to look at. There was 
a total lack of music and the sound effects were only rudimentary. 

The game could have been considerably improved if there were more things to 
pick up and if the screens were different. It would also have been more exciting 
and unpredictable if there had been a longer time available, and if a few ghosts 
had been included for you to avoid. 

However, there was enough in the game to keep you busy for a while, and was 
fairly addictive. After a time, the screens became a bit repetitive and the game 
tended to get tedious. The plot, whilst not specially criginal, has some unusual 
twists which make for a more interesting & enjoyable game than your average Pac— 
Man clone. 

In conclusion then, Mac 3 1s 
a very good game which could have 
been much better by the addition 
of one or two frills. It is still 
a most enjoyable game for several 
hours relaxation & when you cons-— 
ider that you can buy both Mac II 
and Mac 3 (plus a few more games) 
for just £1, they represent truly 
excellent value-for-money and are 
a wonderful introduction to Scull 
Public Domain.For further details 
of this & other bargains from his 
PD library turn to the article on 
page 18 for more information) and 
his address is; 


{ 119 Laurel Drive, Greenhills, | 
j East Kilbride, Glasgow G75 9JG. 


Getting the Key 
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EVENGE 
OF CHAOS by Tony Kingsmill 


Revenge of Chaos is the follow up to the adventure game ‘Island of Chaos’, 
which I reviewed favourably in Issue Four of Print-Out. The game keeps the same 
basic format as its predecessor - all] that changes is the story line. 

In ‘Island of Chaos' you had to bring about the death of the evil warlord, 
Baktron, but now he's been reincarnated by powerful magic and he wants revenge. 
As part of his plan, he destroyed the city of Brael Ti, killing its inhabitants 
instantly. This was just the beginning as his next step was to be much worse.. 

In the adventure. you play the part of the leader of a group of paladins & 
must try to step Baktron from taking over the world. Unfortunately, as luck has 
it, the other paladins have a ‘pressing engagement' elsewhere & leave you alone 
on the island. 

The game itself is written using the Quill and the graphics were designed 
with the Illustrator. I felt that, although it is the sequel to Island of Chaos, 
it was just too similar and so there is not much difference in standard between 
the two programs. The adventure had a good loading screen and fairly descriptive 
le@ecalions. 

As before, the graphics weren't particularly brilliant but there was a not— 
iceable improvement from last time. The usual ‘save’ and ‘load’ functions, which 
are vital with a game like this (it boasts over 76 locations). were incorporated 
into the program, along with a ‘help’ option. Tony also offers a free hint sheet 
for Revenge of Chaos if you get really stuck. and this is also the case with his 
other games. 

The presentation of the game was again good and this gave it a professional 
appearance. As for addictiveness, it had some appeal but I felt that 1t was just 
to similar to other games from the same stable — this should be a plus point for 
Tony's previous customers! As the text was the only thing that had changed, this 
might mean that some people would find the game a bit boring, mit, if you are an 
ardent adventure enthusiast. this should be just the thing (as you're quaranteed 
hours of pugzlement at an excellent price. 

The game costs £3.95 on disc only and comes with a free game, Alien Planet. 
This is in the same mould to Revenge of Chaos, although smaller, and so provides 
more entertainment and challenges for the adventure player. 

If you don't own a disc drive and are sorry to be missing out on the games, 
Tony plans to produce an ‘Adventure Compilation’ later in the year which will be 
available on tape and disc at ‘a very reasonable price’. This will include some 
of Tony's previous releases, as well as the possibility of a new adventure game 
or two. Of course, we'll keep you informed of any further developments. 

In the meantime, here is Tony’s address; 


| 202 Park Street Lane, Park Street, | 
( St. Albans, Hertfordshire ALZ 2AQ. | 
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An _ introduction to | RSXs 
(part 3) 


RE-LOCATING YOUR CODE 


by Bob Taylor 


Often there is a need to be able to load RSXs into any reasonable area of 
RAM and not at one predetermined location (the area usually used is just above 
HIMEM which will itself have been moved to make room for the RSX). In order to 
do this some form of re-location routine will be needed to adjust any absolute 
addresses which occur in the routines, and move with them. We will not need to 
alter any address not within the code that's being moved. (Relocation could be 
achieved from PASIC but, since this is an article about Machine Code programm— 
ing, we will concentrate on self-relocation using this medium) In an RSX init- 
ialisation routine two such address alterations are usually required: those of 
the Command Table & of the Command Name Table. Two further locations will need 
to be ascertained although we can eliminate the requirement for obtaining their 


addresses. 


We are helped here by an undocumented facet of the Operating System which 
results. in the DE register holding the address of entry to a CALLed routine on 
entry to the routine. (This only holds true if the CALL, from BASIC of course, 
isn't accompanied by any parameters.) Any absolute addresses that are required 
will have an offset to this entry point, and so if we add this offset for each 
occurrence to the base address, we can obtain the new address needed.There are 
two main ways of doing this; which one we choose depends on how many addresses 


we have to alter. 


1. If there are few alterations to make we can actually load the BC or DE reg- 
isters with each offset and add these to the entry address held in HL. The 
next routine given gives one method of achieving this: 


nore PUSH Be ee CS) Ee y Ole (I use these numbers alonaside 
all PUSH and POP instructions to show the depth of 


entries on the Machine Stack.) 


5 


.datblk LD H,D tthe 3 instructions starting here will not be needed 

; again so the four bytes involved can be reassigned 
; for use as the chaining Block. 

LD Log c, sH_ now has the entry address also. 

LD (HL) , &C9 ;load the entry point with a RET instruction so that 
: the routine cannot be CALLed a second time. 

LD BC, namtbi-intrsx 

ADD HL,BC sHL-> .namtbl. 

EX De, ;DE-> .namtbl; HL-> point of entry. 


(cont.) 
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(cont.) 


LD BC, comtbl+i-intrsx 


ADD HL,BC *HL_-> byte after .comtbl. 
LD Chk oD : . 
DEC HL : 
LD (HE sload .comtbl DEFW with .namtbl address. HL-> .comtbl. 
LD ByH 
ae) Gal -BC-> .comtbl for KL LOG EXT Firmware routine. 
POP HL sEntry Point (@) (now no entries left on the stack). 
INC HL *HL_~> .datblk for KL LOG EXT. We’re using 4 redundant 
> part of this initialisation routine for .datblk. 
JP &BCD1I sto KL. LOG EXT Firmware routine. 
.comtbl DEFW namtbl saddress used by Firmware RSX handling routine. 
Sx ‘assuming one RSX only, it can start here. 
etc 


NOTE: We arranged things so that we didn't have to calculate the address of the 
Data Block, nor of the entry point for storing the RET byte. Of the two addr— 
esses we did calculate, one was the address of where to store the other. 


This last feature is also common to the second method of re-location and it 

uses a table of the offsets instead of loading registers directly with them. 
Sometimes the table contains both sets of address offsets; ie where to store 
ana what to store. This is however unnecessary and only the ‘where to store 
offsets need be there, the ‘what to store’ ones being at their destinations 
already, waiting to be picked up, added to, and then re-stored again & thus 
saving two bytes per re-locatable address. 


The RSX routine later in this article has this method of re-location incorpora— 
ted into its initialisation routine & shows the ‘where to store’ offsets being 
picked up from a table to create addresses from which existing offsets are then 


picked up, converted and re-inserted. 


NOTE: By making '.comtbl' follow on from the last entry in the offset table, we 
do not have to calculate its address to load into BC for KL LOG EXT - instead 
we just pick up the value of HL which now points to .comtbl. 

NOTE: The second offset table entry has a further offset added: the +1 makes the 
two address bytes the object of the calculations and not the LD HL instruction 
itself. This will apply to most addresses which need altering; however, with 4 
byte instructions, like some for IX and IY & also some for BC, DE “and Sr ¢ ds 
extra offset will need to be +2.Only when an address is present as a DEFW will 


no secondary offset be needed. 
The entries in the offset table can be in any order. Usually there will be more 


entries required than are shown in the example which has been pared for maximum 
efficiency. The addresses to which these entries point have got to be stored as 
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'address-intrsx' in each case (eg as at .addi). It helps to have as few address 
changes as possible, leading to a smaller offset table. We've seen in previous 
articles that by using a JR instead of a JP in the Command Table we can reduce 
the number requiring adjustment and we have already done so here.This can also 
be applied to JPs within the RSX routine itself (although ours is too short to 
have any) by replacing with two or more JRs conveniently placed throughout the 
code to enable the Program Counter to skip from one to another until the wanted 
destination is met. Since this increases the length of the code and also slows 
it down slightly (a JR takes two 'T' states longer than a JP, and we are using 
at least two JRs instead of one JP), it should only be used where time constr- 
aints allow and where a slight increase in room is tolerable.On the other hand 
it may be useful if the need for the extra bytes used by the longer re-location 
routine can be eliminated by having no extra addresses to adjust. 

In the case of sub-routines whose CALL (from M/C) addresses need re-location, 
it is not possible to use Jks of course. 


Sometimes it's possible to write the code in a different way & eliminating 
the CALLs.If the subroutine is used only once. it should be possible to incorp- 
orate it into the main routine at the point at which it was CALLed and so elin-— 
inate the address that way.This has been done with the message printing routine 
below which has then been fine tuned for optimum efficiency. Similarly, if it's 
called only a few times and it is very short, it might be worth while inserting 
copies of it where it was CALLed and so again get rid of the routine altogether. 
All of these things have to be weighed up at the time of writing the code and a 
decision made then as to the best approach. 


The following routine provides two new RSXs comprising a WRITE for placing 
strings in memory with a corresponding READ for retrieving them. The initialis— 
ation routine with which it starts incorporates the second method of relocation 


as mentioned above: 


~intrsx LD H ,addtbl-intrsx :nmote that .datblk is located at the second byte 


; Of this instruction. 


ADD HL,DE tHU-> addtbl. (DE holds the entry address to .intrs~x) 

i) B,&@2 2 offsets of addresses -> addresses to relocate. 
.nxtaedr LD As SF) ;get LB of first/next offset of address. 

INC HL 

PUSH Fi. 37> (1) TBLPOS (Address Table position reached). 

LD Ply ree ;get HB of offset. 

LD L,A ;HL= offset. 

ADD HL,DE sHL= address of address; ie H—-2address to relocate. 

ep A, CHL) ;get LB of this address. 

ADD Fixe sadd in LB of routine entry point. 


enamtbl 


-acdtbl 


~comtbl 


Write 


.getstr 


LD 
INC 
LD 
ADC 
LD 
POP 
INC 
DINZ 
LD 
LD 
EX 
LD 
INC 


JP 
DEF B 
DEF B 
DEF B 
DEFW 
DEFW 
DEFW 
SCF 
DEFW 


OR 
DEC 
DEC 


JR 
JR 
DEC 
JR 
INC 
INC 
INC 


LD 
LD 
LD 


(HL) 5A sre-insert corrected LB of address. 


HL 

A, CHL) ;get HB of address. . 

A,D sadd in HB of entry point + any carry from LB acdition. 

(HL) A tre-insert corrected HB. 

HL :TBLPOS (@) 

HL :step on to next offset. 

nxtadr ;if more offsets — otherwise H.-> .comtbl 

BH 

Cyt ;BC-> .comtbl for KL LOG EXT. 

DE, HL ;HL-> entry point. 

(HL) ,&C9 ystore RET at entry point to stop re-running .intrsx. 

HL sH_L-> byte after entry point to be used as Data Block 
;for KL LOG EXT. 

&BCD i sta log these RSXs on. 


"WRIT, UE" +&80 

"REA", DU +a39 

&OO 

comtbi-intrsx 

addi+i-intrsx 

namtbl-intrsx twill become address of Name Table after re-location 
rsignal ’WRITE’. 

&O1O@ rdummy instruction: absorbs the OR A byte following so 

; eliminating clearing the Carry flag, being treated as 

; LD BC,&B7@0; mext instruction is first DEC A. 2 ’T’ 

; states quicker than using JR ’first_dec_a’. 

;Clear Carry: signal ’READ’. 

ron entry, A held the number of parameters 

:DEC A twice does the same as CP &@2 but maintains the 


Carry Flag (with a penalty of three extra °T’ states). 


Db DP D 


Z,getstr ;Zero set if two parameters (READ or WRITE). 


Cy,parerr 3if WRITE and not 2 parameters. 

A 

NZ,parerr 3if READ and > S (ar <2) parameters). 

ia rclear Zero Flag to signal Length perameter. 

Ix 

IX rstep on to string parameter. IX displacements are now 


identical whether 2 or 3 parameters were entered. No 
further alterations to the IX base address are needed. 


= 
9 


® 
9 


H, (IX+1) get 2nd parameter — 
L, (1X+@) 3 HL=addr of string descriptor. 
A,E son entry to a routine or RSX with parameters, DE will 


hold the last parameter. Assume READ with Length 
parameter so save Length in A; it is not necessary to 
use high byte (which would be @ anyway). If not Length 
then A’s contents will be unused. 


* 
" 
® 
5 


7 


15 


» MOVe 


~parerr 


.Strerr 


.addi 


»OxXxTtchr 


.prtimes 


INC 
INC 


RE? 


LDIR 
Reed 
LD 
DEFB 


Ly 
Lp 
LD 


JR 
LD 
INC 
OR 
JR 
DINZ 


A, (DE) 
c 


sget string length from descriptor. 


*DE=addr of start of string (from descriptor). 
(1) Carry/Zero Flags and possible Length. 


7) 
;step back to ’ length’ byte before string proper. 
;get this *length’. 

:Zero if ‘length’ byte and descriptor length match. 


NZ,strerr ;if no match then definitely not a string. 


De 

De 

re ree. 
Le Lee! 
Sie te 
AF 
C,move 
8 ce 
Z,move 
C 


NC, move 
G8 
asG 


B,2 
c,B 


rstep on again to start of string. 

;get ist parameter — 

> HL=addr to READ from, or WRITE to. 

sassume WRITE so DE->addr to WRITE to; HL->string start. 
;Carry/Zeroa Flags and possible Length parameter (@). 

rif WRITE then DE, HL and string length set correctly - 
sotherwise DE->string for result; H.->addr to READ from. 
;if READ and no Length parameter. 

;compare Length parameter with length of string - use 
: whichever is shortest. 

rif Length is greater then use string length (in ©) — 


sotherwise move Length into C. 


-if Length/string length is @ then do nothing. 
;BC=length to transfer (for LDIR). 

stransfer to string if READ, or from string if WRITE. 
;to BASIC. 

;Signal ist error message. 

;dummy line: combines with the next two Bytes to appear 
; as LD DE,&@O206 if entering at .parerr so avoiding 

; re-loading B with 2. Next instruction is LD C,B. 
;Signal 2nd error messace. 


;Ssave the message number. 


H_,errmes-intrsx jafter re-location, HL will -> error messages 


prtmes 
A, (HL) 
oo 

A 


3; starting with ’Check Parameters’. 
sinto the message printing routine. 
;get first/next character. 
sstep on to following char. 
;a byte of &@0 is used to end a message string. 


NZ,nxtchr 3if not the end of the string. 


nxtchr 


senter routine here; ist error message goes straight 


; into .prtstr, 2nd goes via .nxtchr to find end of ist 


;messade. 


-prtstr A, CHL) ;get first/next char. of string to print. 
OR A 
CALL NZ,&BBSA sprint char if not the end marker; all registers and 
; flags preserved. 


ING HL ;step on to next char. 

JR NZ,prtstr 3;for next character if not end of message marker. 

LD A, 32 

ADD A,C Z-ERR number; gives 33 for parerr & 34 for strerr. 

LD Ca ;for ROM @ (BASIC). 

LD HL,&CBS5 3; (&CA9S for 464); BASIC’s Error Handling routine in ROM. 
JP &OO1B ; to FAR CALL ta ROM; the Error Handling routine alters 


the stack so doesn’t REturn. 


-errmes DEFB "Check Parameters", &@@ 
DEFB "Check String", &@@ 


Although not cbvious initially, the routines for WRITE and READ have much in 
common and so have been amalgamated into one. using the Carry Flag to indicate 
where the two routine paths differ from each other. 


~~ murVv 
EIN LIAN 


The full syntax of each RSK follows: 


_ 


IWRITE ,<Address to store string at>,<String to be stored/(@)String Variable> 


The string must be previously assigned to a variable for the 464, which must 
then be preceded by @ when used here. 


(READ ,<Address to read string from>,<(@)String Variable or (@)Array element 


for resultol,<Length of string to be read>] 


The String Variable must exist before use here; ie it must have been assigned a 
string with length equal to or greater than the number of characters to be read 
from memory. In the 464, it also must be preceded with @. It is not possible to 
use the command form of MIDS as a parameter since this is always interpreted as 
its function form. 

If present,the ‘Length of string to be read’ parameter will be compared with 
the length of the result string & the shorter of the two used.If the Length is 
shorter than the string, only ‘Length’ number of characters will be read from 
memory; the rest of the string will remain as before. If the string is shorter 
or if this optional parameter is omitted. the whole of the string will be read 


into. 


In the final article in the series, we shall be looking at the way that RSXs 
can be installed in ROMs. 


119 lauvel Drive, East Kilbride 
Glasgow €75 9dG. 03552 24794 


One of the major introductions to the library are the demos. To be blunt, 
demos are totally useless, but they're wonderful to watch & a delight to listen 
to. Unfortunately, there are very few (if any) demo writers in the U.K., but in 
Denmark, the competition between demo writers is strong. 

The best of the Danish demos come from New Way Cracking and United Amstrad 
Crackers. From the demos in my library, N.W.C have the edge. Their demo called 
FINAL CREATION must be the best demo available for the CPC. 

On loading FINAL CREATION, you're presented with the copy-chain.This allows 
you to copy the demo (it uses a special version of DATA format) but best of all, 
when you pass it on to your friends, you can leave messages for them which can 
never be removeci 

After the copy-chain, you're presented with a spectacular display of graph— 
ical genius. The screen is enlarged to use the whole monitor, with the top half 
showing part of a face & the bottom half showing a massive multi-colour animated 
scrolling message. A fantastic tune blasts out from the built-in speaker & this 
adds atmosphere to the demo. 

Tf I've not yet convinced you to get some of the demos. then remember that 
it is extremely difficult to describe the quality of graphics & sound in words. 
They really have to be seen to be believed. 


Most people will agree, Stop Press is an excellent D.T.P. package. But, it 
does have it's limitations. One of these is the size of fonts that can be used. 
As fonts can only be designed om a 16 by 16 grid. enlarging them to even double 
size causes a blocky effect.That got me thinking, what about making a font from 
cut-outs? Sounds sensible, doesn't it? So I sat in front of the computer & des- 
igned a very large font to be used for headlines & such.The result was a smooth 
felt-—tip font that was a 100 times better than a normal enlarged one.Of course. 

so I also desiqned 8 new normal fonts (including 
to the Amstrad one) and a page of clip art - 


this would not fill up a «dick. 
two small fonts as an alternative 
containing some digitized pictures — to go along with it. The result is PD DISK 
79, the ultimate ‘add-—on' for Stop Press. Disks soon to be released include Art 
Disk 2 and Hack Attack which contains 50 pokes & a Multiface Poke DataBase com— 
plete with details of over 160 multiface pokes. Adventures Five is also due for 
release soon & so is Applications 3. Also look out for a game produced by Glenco 
Software using Sprites Alive.This game will be reviewed by Amstrad Computer User 
and Scull PD Library will be the first to have it. In fact it should be ready by 
the time you read this. 


On the next page is a very concise stock list and details on how to order, 
as well as a mini-order form (you can photocopy it if you don't want to hack 
your valuable copy of this mag:). These should be read carefully, but if you 
are unsure of anything. feel free to give me a call on (03552) 24795, Monday 

18 to Friday, 7pm to 1llpm only. | 


PD DISKS LIST — SEPTEMBER 1990 — SCULL PD LIBRARY 


O01 Serious 1 22 Quiz 1 65 Serious 4 

02 Games 1 23 CPM Applications 1 66 Dazzlestar CPM 

03 Games 2 24 CPM Applications 2 67 CPM Languages 1 

04 Animations 1 25 CPM Applications 3 68 CPM Languages 2 

05 DW 1 26 Games 7 69 CPM Languages 3 

06 DW 2 27 Mini Prop (CPM) 70 CPM Applications 4 

O07 Applications 1 28-33 Demos 1-6 71 Introduction 

08 Games 3 34 Mag Indexs 85-87 72-74 JRT Pascal (CPM) 

09 Serious 2 35 Phone Codes 75 M Basic (CPM) 

10 Games 4 36 Revision Aida 76 CPM Applications 5 

11 Al/Education/Gfx 37 CPM Assemblers 77 Bev Art Studio files 

2 Games 3 38 CPM Adventure 78 Games & 

13 Animations 2 39 Demos 7 79 Stop Press Clip Art 

14 Art Disk 1 40 Demos 8 80 Yet more demos 28 — 

15 Adventures 1 4] CPM Games 81 Serious 5 

16 Geno Adventure 42 Demon PD Disk 1 

17 Applications 2 43 Adventures 3 NB: Disks 72-74 must be ordered 

18 Games 6 44-61 Demos 9-2Z6 together. 62 requires proof of 
_ 19 Adventures 2 62 Over 18's Demos age. Disks 28-33 and 44-61 can 
| 20 CPM Mise 1 63 Vidi Digi Pics be ordered separately and are 

21 Serious 3 64 Adventures 4 listed together to save space 


PD is available on both 3" and 5.25" 


disks. The latter format is only comp- 
atible with drives that use 80 tracks, 
even though the CPC uses the first 46 
tracks only. & either 1 or 2 sides can 
be used -— in normal 178K or 169k form 
ats. You can get any of the above disks 
by sending £1.00 per disk, the correct 
amount of disks and an SSAE or you can 
receive full details by sending a disk 

and SSAE. All of the above selections [ would like to order the following selections 
require ONE side of a disk only. Also . 

enclose a blank disk for the stocklist Pd disks __., ——, ——» ——» ——» ——» —— 
disk mag. All orders should be send on ‘Tick here for Rebound and Bandit 

the form opposite. 


Name 
Address 


Remember that Rebound and Bandit (© 
NON-PD games reviewed in Issue 4) are 
still available. They cost £5.00 (for pele hone, MuMber | josed 
both) if I supply the disk, or for a Money enclosed 
copy-charge of only £1.00 each if you ~ og . 
supply the disk. Rebound is a break- Fild thés in and send dt to the address tetow 
out clone with a difference. there is 
not bat! — "a most professional piece 
of software'’ P-O Issue 4. Bandit is 4 
fruit machine game with 5 mini-games: 
— "Tf you are the gambling type then 
this is surely the game for you" P-O 
Issue 4. Full details can be found on 
the stock list disk mag. 


| 4 


179 laurel Drive, East Kilbrid 
Claseow 675 910. 03552 2479 


un h Wot 
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nas’ POKING AROUND 


The two main languages on the CPC, BASIC and Machine Code, both have their 
advantages and disadvantages. While Machine Code provides many features that are 
unavailable in BASIC, it's difficult to learn & complicated to program. It would 
be very useful if we could access these bits of ‘Machine Code Magic’ from within 
our own BASIC programs but unfortunately this is almost impossible in nearly all 
cases However, in the CPC's memory, there are certain addresses that contain the 
various bits of information that are necessary for the computer to run correctly. 
It's a very simple matter to change the data stored in these addresses from with- 
in BASIC, via the POKE command. The only drawback is that you're very limited as 
to what you cam achieve and that the results are by no means certain. Therefore, 


printed below, are various snippets of information (& almost all are in the form 
of 'pokes') that I have come across over the years. Whilst none of them are par- 
ticularly exciting, they all do things which would either be much harder or even 


impossible using BASIC alone. 


Un-erasing_files 

I'm sure that we all know the terrible feeling when we accidentally erase a 
disc file that we had intended to keep. Well, help is at hand. When you erase a 
file, it is not immediately removed from the disc but instead is stored in user 
area S&E5. The computer then records that the disc space where this file used to 
be is now free. 

User Area &E5 is illegal and is not normally accessible but it is possible 
to trick the CPC into letting you use all 256 areas by poking the address &A701 _ 
with the desired user number. This allows you much greater flexibility over disc 
organisation. The side effect is that if you poke &A701 with &ES (229), you can 
load any files which have been erased. 

Unfortunately, because the space that was filled with the ‘erased’ file has 
been recorded as being free, any program which you save may occupy this space on 
the disc. This will also not retrieve files on a disc that has been reformatted. 


Removing Spaces 


Here's a quick little poke of varied use. If you're one of those people who 
like to insert extra spaces in lines (eg. 10 PRINT "Hello') and then wish that 
you hadn't included them, possibly to produce the right code in Amstrad Action's 
Typewriter program, then the answer is to poke &ACOO with &FF. This then removes 


any extra spaces. 


Resetting ‘TIME’ 


The CPC includes a BASIC function ‘TIME’. It records the time that has gone 
since you switched the computer on and can be printed using PRINT TIME. However, 
there is no way of resetting this clock from within BASIC. But if you enter the 
following lines, then you will find that it is reset to 0. 


10 REM Reset TIME for the 464 10 REM Reset TIME for the 6128 
20 POKE &B187,0:POKE &B188,0 20 POKE &BSB4,0:POKE &BSEBS,0O 
30 POKE &B189,0:POKE &B18A,0 SO POKE &BBSB6,0:POKE &BSB7,0 


By changing the numbers that are poked in lines 20 and 30, you can set time to 
whatever value that you want. If you're interested, the total time that can he 
recorded using the TIME function is about 166 days !! That's enough for me -¢- 


CAPS/SHIFT Lock 


If you've ever wanted to be able to turn the CAPS or SHIFT LOCK on/off in a 
BASIC program (for example whilst getting a name for the hi-score table) all you 
have to do is poke the addresses below with &FF to switch it on and &00 for off. 


464 CAPS LOCK &B4E8 6126 CAPS LOCK &BoS2 
464 SHIFT LOCK & B47 6128 SHIFT LOCK & BOS 1 


Disabling _ESC 


A query that seems to come up time and time again is, how to stop the ES 
key from working. The simplest and best method is to poke &BDEE with &c?. This 
stops all types of break including the CTRL-SHIFT-ESC. If you want to restore it 
to normal, poke &BDEE with &C3. 


Useful Calls 


There's one last category of meddling that you can do and that is to access 
firmware routines direct from BASIC. These are dome using the CALL command. The 
problem is that you are unable to pass parameters to the Machine Code routine & 
so you are restricted as to what you can achieve. Still, here are some addresses 
that you may find useful to CALL. 


CALL &BCO2 — resets the colours to those used when first switched on 

CALL &0000 - completely resets the computer (equivalent to CTRL-SHIFT-ESC) 
CALL &BBOS - clear key board buffer (has some side effects) 

CALL &BBO6 - waits for a key to be pressed 


Next issue we'll see if we can drag up some more useful pokes and things to 
do with your CPC. Remember, if you've any of your own then please send them in. 
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Programming the Z80 
Machine | The STACK 


Code... 


eaee 


We have now looked at some Machine Code programs which are becoming fairly 
lengthy and complicated, but there are still one or two common commands that we 
have omitted. In this issue, therefore, we are going to look at these commands , 
some of which we have already used but not explained. 


In the very first part of this series, we were introduced to the registers 
(A.B.C,D,E.H,L) and these were likened to BASIC variables except being far more 
ited. The cbvious problem was that they could only store numbers with values 
from @ to 255 (pretty small in computing terms). This could be then overcome by 
forming register pairs (BC,DE.HL) from them — these could then hold values from 
@ to 65535 (ie a 16-bit number). 


Whilst this is fine in theory, it does have some limitations. Suppose your 
ing which is not 


Net Set At 


i 
program needed to store and work on four 16-bit numbers (somethi 
unreasonable!). we would find curselves with a problem — we've got only 4 regi- 
sters that are capable of holding such a number! 

One way around this would be to poke the numbers into a safe place in mem- 
ory when we weren't using them, and then retrieve them when they were require 
This would be a very space comsuming exercise, and also very frequent, So we 're 
thoughtfully provided with a couple of commands to do this — PUSH and POP. 


Us AND POP 


PUSH and POP are used to preserve and retrieve register pairs for use later 
on. The first thing to notice about them is that they can work only on reqister 
pairs. and not on individual registers — however, his is not a problem for all 
we Go is PUSH cr POP the corresponding register pair instead. For example, if B 
was to be preserved we would simply use PUSH BC and then to retrieve, it POF BC. 

In the previous paragraph, I mentioned a safe place where numbers could be 
stored. When using PUSH and POP, one area is allocated for this express purpose 
—~ the Stack. I have heard the Stack being explained in many ways but one of the 
best ways of thinking of it is as a pile of boxes. Imagine that each box really 
represents a memory location, and so has an address. Unfortunately, these boxes 
have lids on, and so the only one that you can look inside is the very top one. 
When you give a PUSH command (eg. PUSH HL) the computer takes the number in HL, 
and puts it in the top box. If you then do another PUSH (eg. PUSH BC), the CPC 
adds another box on top of the pile and puts BC into it. Now, when you come to 
POP something off, the only number you can get at is EC. 

The Stack is often called a ‘last-in, first-out' (LIFO) stack because that 
is exactly what it is. You can put things on top of it but ONLY at the top, and 
you can take things ONLY from the top. 
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To illustrate this, follow the below example through: 


&o7 BS 


is empt 


LD BC,&6789 ; BC = &%6/789 

LD DE,&3453 ; DE = &3453 

LD HL, &€@@12 ; HO = &@@12 

PUSH BC : stack holds %6789 
PUSH DE : stack holds &3453, 
PUSH HL 3 stack 

LD HL, G@00 > HL = &0@00 

LD BC, 000 ; BC = &@0O0 

LD DE, G@09 ; DE = &@000 

FOP HL 3 HL = &@O1z 

POP DE : DE = &3454 

POP BC ; BC = &6789 


the left hand number on the stack 
number 


In this, 
right most is the number at 
the Stack, 
bottom of ¢ 
The Stack 
(although 
on for too long). 


we don 


Fortunately, t have to make life 
as we remember that it a LIFO stack, we 
is and where it is located. We can, of 
the Stack Pointer (SP) ~ more of that la 


try and puzzle over this - the Stack is 


(*) as the 


the bottom. If you 


a i 
location th 


G could a 


complicated for 
ee 


do not n 


¥ 


d to know 


meddle with 


holds &@012,&3453,u&6/789 x 


stack holds %3453,&6/789 
stack holds &6789 


stack 


the top. & the 
you understand 


ourselves and. as lond 
which way up 17 


the stack by use of 


So far, we've just been preserving registers for use at a later date, but 
we can also use the PUSH and POP commands to do one or two other things. Using 


Lore 


a Z8@, we cannot do load one register pair with anothe 
LD BC.HL). instead we have to go about 1t in a very 
LD HL,&/@356 7; HL = &/036 
LD AL >A =L = &56 
LD C,A > C =A = &5 
LD AH > =H = &7O 
LD B,H > B=A = &/@ 
>; BC = H_ = &7?@36 
Using PUSH and POP it is much simpler: 
LD HL,&7@56 ; HO = &7056 
PUSH HL ; put the number in HL (&7@56) 
POP BC ; take the number from the top 


put it into BC, 


a 
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ie BC = HL 


(such as 


on the top of the stack 
of the stack (&/@56) 
&/@D6 


ana 


There's just one other thing to bear in mind when you are dealing with the 
Stack and that is that it is not only PUSH and POP which make use of the Stack. 
The CALL and RET commands also use it extensively. When a subroutine is CALLed, 
from a Machine Code program, this is what happens: firstly the address that the 
program should return to, when it has done the subroutine, is put on the Stack. 
The program then jumps to the subroutine and continues executing the code from 
this point. When it encounters a RET instruction, the computer takes the number 
from the top of the Stack (the return address) and goes to that place. 

All of this works very well until you start using PUSHes and POPs inside a 


subroutine. It is then imperative that everything that has been PUSHed onto the 


Stack is then removed by use of POP. Below is an example of how NOT to do it: 


ORG &BOOO 
CALL hello > CALL the subroutine labelled ’.hello’ The address of 
the LD BC,&C@ instruction is now placed on the Stack 


LD BC,&Cce 
RET 


any instruction would have done here 
RETurn to BASIC 


hello PUSH HL put HL on the stack 
_ PUSH BC put BC on the stack 
TEOAg72 A = 72 (ASCII for H) 
“CALL &BBSA » print H 
ao ae 2 ; take BE ert the Stack 
LD 4,165 > A = 1@5 (ASCII for i) 
“CALL &BBSA ; print i 
RE? : RETurn from the subroutine 


Unless you are extremely lucky, this program will cause a crash and you'll have 
to reset the computer. The reason for this is that, in the subroutine. we put <2 
things on the stack and only took 1 off. This left one extra item on the Stack, 
and the computer took this as the return address, jumped to it, and....Crashed: 


There is just one further feature concerning the stack, the Stack Pointer. This 
keeps track of where the top of the Stack is. Every time we PUSH something onto 
the Stack, the Stack Pointer is decremented (remember the Stack 1s upside down) 
by two (we are PUSHing a two byte register pair) & when something is POPped the 
Stack Pointer is increased by two. Of course, we can alter the Stack Pointer as 
if it were a normal register (eg LD SP,&189¢ DEC SP. -ete) and this can pro= 


duce some rather interesting effects — some of which we will be looking at ina 


future issue. 


As you can see, the Stack, PUSH and FOP are very useful items, without which it 
would be even harder to program in Machine Code. They can also be pretty lethal 
if not used correctly — so when using the stack, make a note of what you've put 
on it and then removed. That way you cannot go wrong! 
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PRINI~OUL S ASSEMBLER 


As promised last issue, we now have our very own assembler which will allow 
you to enter all of the Machine Code programs that are printed in this magazine. 
without having to resort to using an expensive alternative. 

As we have now got an assembler, we do not intend to print the BASIC Poker 
numbers in future issues. However. because of the rather extensive documentation 
which needs to accompany the program and also its length, we have been unable to 
include it in the magazine (it would have taken up about ten pages). Instead, we 
have Bae it, and full instructions for its use, on this issue's program tape and 


an 


Our assembler has been designed to be, as near as possible, compatible with 
Maxam (widely regarded as the standard for assemblers on the CPC) and you should 
be able to use it with any other magazines’ Machine Code programs. The assembler 
€ ines -— namely to put them in 
a BASIC program, preceded by a short REM = and then assembling them through an 
RSX. This avoids the need to include a memory hungry 


program both powerful and flemible. This also provides the added benefit that we 


xt Editor’ and makes the 
can supply any Machine Code listings on the program tepe/disc as a BASIC program 
which can then be assembled (thus saving you typing) 

This system is as friendly as is possible for a Machine Code Assembler, and 
it tells you of any errors in the way that the code has bsen written. Due to the 
nature of the system it needs an ‘END’ directive to be included so it knows when 
to stop assembling. Full details of this are contained on the tape or disc. 


SWAP — 


ISC HiSoeft Fascal, 
O 


fiware. Ideally I 


One DMP 216@ Printer. .One 256K Memory Expansion with | 
co 


would like to swap f 2 1 m also willing 
toa sell. Also wanted a good C.A.D. Syst 


Basildon, Essex, SS14 10W 


nterface and Modem but I 
tem, 5 


Terry Gipps, 5@1 Long Riding. 


WANTED ~— Issue One of Amstrad Computer User and issues April 1989 onwards. Will 
pay good price (especially for Issue One) or will swap for as much PD as 
deemed reasonable. Alan Scully, 119 Laurel Drive, East Kilbride, Glasgow 


ae 


G75 9IG. Telephone (@3552) 24795. 
FOR SALE — 2 Homebrew programs, Casino Blackjack (a realistic Simulation of the 
gambling game) & Wordsearch (a utility for solving wordsearch puzzles) 
As reviewed in Print-Out Issue Six. Both programs cost £4.5@ together & 
this includes the cost of a disc. Contact Barrie Snell, 19 Rochester Rad, 
Southsea, Portsmouth PO4 OBA. 
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Amstrad has released its new Plus computers and console, thus ending months 
of speculation by the computer press. Whilst it would appear that a large amount 
of thought has gone into the design of these new machines, Amstrad seems to have 
overlooked some rather important factors in their specifications. Firstly, there 
is no tape interface on the 6128 Plus, thus cutting out almost all of the budget 
market and removing the option of truly low-cost software. It may be possible to 
add an external interface at some later date, but it does not seem very sensible 
for Amstrad not to have done it themselves. Another major problem, the different 


é 
use of a small plug-in adaptor available from W.A.V.E. 
I must say that the custom hardware chip certainly makes the computers look 


ST, although why the sound could not have been more rad- 
to existing owners 
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y oved at the same time, is beyond me. When it comes 
upgrading, I think the most serious problem that Amstrad will face is the worry— 
ing la¢k of information about compatibility between machines. We have been told 
that 99% of software will work on both the old CPCs and the new Pluses. but what 
about all of the hardware? I am not prepared to buy a Plus until I know that all 
my add-ons, ROMS, etc will operate correctly. There's no doubt, in my mind, that 
Amstrad could have a very successful computer in the Pluses. but the question is 
will they be able to capitalize on it. Only time will tell. 


The new comsole also looks as if it may have a rough time. unless the price 
f cartridge software drops from the quite staggering £30 that is being asked at 
present. After alli, cheap it may be, but it's up against some fairly stiff comp- 
tition from the likes of Nintendo. 


Spectrum _+3 dropped 


Also in the last couple of weeks. Amstrad have made what is, in my opinicn, 
a very sensible move — they've dropped one of the Spectrums. The Spectrum Plus 3 
is no more, thus making way for the far superior 6128 Plus — its main rival. The 
news came as a bit of a shock to Spectrum owners but it certainly shows us where 
Amstrad's priorities lie (at present) .However, all of this has been overshadowed 
by the new ‘Generation 3 PCs' which are due for a launch in the near future, and 
Amstrad are pinning their hopes on the success of these computers to raise their 
flagging fortunes. After another disastrous year with its audio and video range, 
Amstrad desperately needs some good news as they have recently announced another 
downturn in pre-tax profits. Let's hope that Amstrad have finally got everything 


sorted out |! 
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DISC 
-NAMER 


BY BOB TAYLOR 


The purpose of this utility is to provide an identity for each side of a 
disc whenever it is CATaloqued. The idea comes from MS—DOS and DR-DOS (as used 
on the IBM PC and other computers) where each disc is allowed a ‘Volume’ name to 
identify it (both sides of each disc are treated as the one disc). 


Of course we have to turn cur discs over to access another side, and so it 
becomes doubly useful to be able to tell which side of which disc we are using. 
The ‘name’ written to the disc by this utility is inserted in the disc's Direct— 
ory area so that it appears on the screen each time we use CAT. In doing so it 


takes up one of the possible Directory entries leaving 63 available, but never 


Having Tun out OF diveetcry space.» I don’t see this. asc. problem Tor most users, 


It is possible to have up to ten characters in the name. However, when it 
is printed by CAT a full stop will appear between the 7th and 8th characters so 
it is best to arrange your name to fit in with this. 

A space is automatically placed before the name when written, with the end 
result that the title will be the first name printed by the CAT. A further aid 
to clarity is to use lower case for any letters, to make it obvicus that it is 
not the name of a file. 

This utility works only on discs which have been previously formatted with 
SYSTEM or DATA. The routine will trap such errors as disc missing, no name,name 
too: ond, etc.. and also allow renaming of Sides. Pirst, type im the loader pro- 
gram below (and save it before running it). 


When RUN it will prompt you to press 'S' to save the code as 'NAMEDISC.BIN'. 
The routine is now ready to-use (NB &90D bytes of space ere needed). For future 


use just use: MEMORY &7FFF:LOAD'NAMEDISC. BIN" 

TU INEINEEING | TE Te ia 

ALI THE Mo Pb tho ob INDINGE Thi 
The syntax to use for naming a side of a disc is: CALL &B8000, "name" 
However, unfortunate 464 users will have to use : ag$="name":CALL &8000, Gas 


Remember that you will need to name both sides of a disc separately as a CPC 
treats them as if they were two completely different discs. So simply turn the 
disc over and then name the other side. 
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[Fil 1@ ’Disc Namer Loader by R Taylor for PRINT-OUT (Public Domain 1999) 
2@ MEMORY &7FFF:RESTORE 11@:PRINT:PRINT"Please wait a few seconds” 
3@ FOR lin=® TO &10D/8-1:total=@:FOR n=@ TO 7:READ as . 


CCl] 
C19] 
CA2] 
C4B] 
C21] 


(C4) 
CBBI 


C83] 


4D 


5@ total= 


5@ 


byte=VAL ("&''+as) :POKE &8000+1inke+n, byte 


total+byte:NEXT n 


READ aS: IF VAL ("&'!'+a$)<>total THEN PRINT:PRINT"Error in line" 1link1@+1190 


> END 


7@ NEXT lin 
PRINT:PRINT'AlL M/C loaded':PRINT:PRINT'Press ’S’ to save M/C as 


N@MEDISC. BIN" SWHILE INKEYS="""SWEND:IF INKEY(6@)<>-1 THEN SAVE 
“NAMEDISC. BIN", B,&B000, &10D 
PRINT:PRINT''To Load and Initialise Disc Namer with a program present 
just Enter:":PRINT MEMORY &7FFF:LOAD'CHRS (34) 'NAMEDISC. BIN'CHRS (24) "': 


BO 


9O 


eed 
S 
a) 


ao 


Bb Whe 


CD 


bes pom be j— 
OS 2 8 


N) 
) 


> 0 DO sw 
>» & 


a CA A GI oh} WN) 
> 
& 


CALL &8@@@":PRINT' in Direct Command Mode" 


END 

DATA 
DATA 
DATA 
DATA 


) DATA 


DATA 
DATA 
DATA 
DATA 


) DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


9 DATA 
2 DATA 


DATA 
DATA 


2 DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


3D, C®,21,04,80,CD,D4,BC,4C5 
D@, DF,C1,80, 06,04, 34,51, 385 
BE,£6,F0,B0,4F,FE,44, 16,468 
O2, 28,02, 16,00, 1£,00,21,081 
BO, A9,E5,D5,C5,DF,C4,80,5FB 
30, 25,06,10,11,EF,01,19,195 
7E,B7, 28, 1F,FE,E5, 28,38, 3C2 
11,£0,FF,10,F2,C1,D1,£1,545 
@D,10,DF,21,CB,80,C3, BS, 3E3 
80,21,FC,80,CD,B8,80,F1,513 
F1,F1,C9,E5,21,D0C,80,CD,5DA 
BS, 80,E£1,E5,11,F2,FF,19,519 
CD,BS,80,21,F1,80,CD,B8,51C 
80,£1,CD, 06, BB,E4,5°,FE, 532 
59,20,DC,11,F1,FF, 19,36, 305 
00, 23,36, 20, 23,EB, DD, 66, 208 
01,DD, SE, 0%, JE, FE, @B, 30, 303 
CO, 4F, 23, 7E, 23,66, 6F, @6, 2AE 
00, ED, BO,EB,7D,E6, if, DS, 4E0 
1D, 30, 9A, 2F, 87, 28, 06,47. 1B2 
36, 20,23, 10,FB, 26,14, 36, 1D4 
02,23, 1@,FB,C1,D1,£1,DF, 48 
C7,80,11,0C,81,C3, 9B, BC, SFF 
7E,B7,C8,CD, 5A, BB, 23,18,41A 
F7,60,C5, 07,66, C4, 07, 4E, SBO 
C6, 07,02, 44,69, 72,65, 63, 376 
74, OF, 72,79, 20,66, 75,60, 335 
5C, 0A, OD, 20,44,59, 73,63, 206 
20,61, 6C, 72,65, 61,64, 79, 302 
20,6E,61,6D,465, 44, 20, 22, 267 
00, 22, 0A, 2D, 52,65,6E,61, 1BF 
5D, 65, 3F, 20,00, OD, 4,61, 1D7 
6D, 65, 20,74, 4F, oF, 20, 4C, 2D0 
6F ,6E, 67, 20, 00, 00, 2, 00,144 
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A PROGRAM TYPING AID 


All programs in Print-—Out have 
Linecheck codes which are enc— 
losed in brackets at the start 
of a line. Don't enter them in 
as they're designed to be used 
With Linechecker to eliminate 
errors when typing in programs 
which appear in this magazine. 
Please note, all programs will 
run whether Linechecker is be- 
ing used or not. For informat-— 
ion on how to use Linechecker, 
please see Issue Three. 


ADVANCED BASIC ~ 


BASIC tokens 


BY Bob Taylor 


The Operating System stores BASIC Commands and Functions in memory (and on 
Disc) not as a string of letters as we see them when printed on the screen, but 
by using a system of substitute values, which are called Tokens, & I thought it 
would be useful to provide you with an extended list of these Tokens and other 
codes used in the PROGRAM AREA of memory. 


I suggest that you confirm for yourselves the information given in this article 
by using the BASIC program in listing 1.Type in extra lines containing examples 
of Tokens (using Line Numbers from 10 to 90 only) and then use RUN 1000, RUN or 
GOTO 1000 as the case warrants. You will notice that the value of every byte is 
given in Hexadecimal format which gives a clearer display than using decimal. 


Listing 1: 

C44] 1000 line.start=&170 

CBB] 1010 line. length=PEEK (line. start) +256xPEEK (line.start +1) 

[D6] 1020 line.number=PEEK (line. start+2)+256xPEEK (line.start+3):IF line. number 
>99 GOTO 1070 

[CE] 1030 PRINT:PRINT line.number" ("STR$ (line. length) ")"; 

C96] 1040 FOR n=line.start TO line.start+line. length-1 

C78] 1050 PRINT" "HEX$ (PEEK (nm) ,2) 53: NEXT 

C06] 1060 line.start=line.starttline. length: GOTO 1010 

[2A] 1070 PRINT:END 


When run, the program will print out data for any lines present, which are 
numbered less than 100. Each line's data will start on a new line and will give 
the LINE NUMBER in decimal followed by a figure in brackets. This is the LENGTH 
(also in decimal) of the line. Finally, there will be a sequence of Hexadecimal 
representations (without the '&' prefix for clarity) of the contents of all the 
bytes in that line, starting with the length bytes. 

The LINE NUMBER is cbtained from the third and fourth bytes of the line & 
the LENGTH from the first and second bytes by using the method explained below 
for calculating numbers from two byte values. Incidentally, while you can only 
type in 255 characters for each program line, it is possible to have some line 
lengths much longer than this (304 bytes is the maximum since this is the size 
of the LINE INPUT area for tokenised lines) and the reason is given below. The 
last byte in each program line is the END OF LINE MARKER, byte &00. 
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Tokens are used to store such things as COMMANDS & FUNCTIONS in a program 
in a much more compact form; compact because a Token usually only occupies one 
byte of space compared to 9 characters required to write some COMMANDS. Tokens 
are also used to indicate the different types of VARIABLES and even to express 
various ranges of Numbers but often in these cases more space is required than 
in the original text (this is the reason for the longer line lengths).Here, as 
in the case of Commands and Functions, the real gain is in the speed of handl— 
ing of BASIC, when RUN, since the line is in a more ‘digestible’ form for the 
Operating System. 

I have split the Tokens into two tables. Those in the second list are all 
Functions and must be preceded by a byte of &FF. The first table is by far the 
most extensive and contains the Tokens for all the COMMANDS, for VARIABLES, for 
NUMBERS and for SEPARATORS and DELIMITERS. Also included here are three Funct— 
ions: ‘MIDS! and ‘FN' which also double as Commands but use an identical Token 
for both forms: and 'ERL’ which is only a Function. None of these three have a 
preceding &FF byte im their Function usage. 

& few Command Tokens are preceded by a byte of &O1 and another’s followed 
by &£00; these bytes are inserted automatically by the BASIC Editing routine as 
the line concerned is ENTERed into the program, but their presence will not he 
seer when the line is LISTed or EDITed. 

Note the coincidence in the use of &C9 to represent BASIC’s RETURN command 


as well as being the code for the Assembly Language 'RET' mnemonic. 


Six Tokens are used to indicate the different types of Variables and these 
have values of %02,%03,%04,%0B,%00,%0D to show whether the Variable is Integer, 
String, Real,DEFINT,DEFSTR or DEFREAL/undefined respectively. There then follow, 
not tokens.but two distance bytes to facilitate speedy location of the required 
variable in the ‘VARIABLES 4REA' in memory. Upon ENTERing a line these are left 
blank and contain &00 and &00.However, after this section of the program's been 
RUN, they usually contain the distance from three bytes before the start of the 
Variables area (which is the END OF LINE MARKER at the end of the last line of 
the Program) to the first character of the name of the Variable where it's sto- 
red in the Variables Area.Having the distance already calculated will save time 
whenever this part of the program is encountered again. The distance is stored 
with the low byte first, high byte second in the standard way. 

The BASIC Parser (that part of the Operating System which scans along each 
program line at run time and puts the Instructions there into action) takes any 
'distance' value other than &0000 and uses it without checking its validity (do 
not try poking Variable distance bytes). If &0000 is present, because that part 
of the program has not yet been used, then the Variables Area is searched from 
the beginning for the required Variable and when found, the correct distance is 
stored in these distance bytes. There are some exceptions to this, however; eg. 
the distance bytes of a non-existent variable cannot be calculated of course so 
if an Instruction just refers to a previously unused Variable without requiring 
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it to be established (in the case of PRINT) then the distance bytes will remain 
empty. 

Like the handling of Line Numbers (see later) Variable distances are reset 
(to the original &00 and &00 in their case) on amending any line of a program. 
Following the distance bytes come the actual characters of the Variable's name 
exactly as typed in, lower or upper case, letter or digit, except that the last 
character of the name has its bit 7 set, ie. it has &80 or 128 decimal added to 
it. There can be up to 40 characters in a name (letters, digits, "." and "#" 
although the latter can only be the first or last char and is ignored anyway). 
All the above also applies to Control Variables (those used with the FOR 
command) which will appear indistinguishable from normal Variables. 
Similarly with the Variables which are used as Function Names with DEF FN's and 
FN's, although it should be pointed out that in the Variables Area, Function 
Name Variables exist separately from any normal Variables with the same names. 


ARRAYS 

At first sight it's easy to mistake a tokenised Array for a Variable; there 
is a type byte (using the same Tokens as for Variables) followed by two distance 
bytes, then the Name characters, again as for Variables). Already, however we've 
missed one difference ~— the distance bytes now give the distance from five bytes 
before the Arrays Area (cf. with that for Variables area) to the first character 
in the name of the required Array where it 1s stored in the Array area.Quite why 
the distance reference points chosen for Variables & Arrays should be where they 
are, is beyond me.The other big difference is that the name of the Array (in the 
program area) is followed by one or more subscript numbers separated by commas & 
enclosed by brackets; the forms of these numbers are as given below. 


RSXS 

The special symbol ‘:', used for User Commands like RSxs, has a byte of &00 
inserted following its ASCII when used in this way, giving the sequence &7C &00. 
Following this, come the actual characters (converted to upper case) & digits of 
the RSX name, with the last one having bit 7 set.Any parameters which follow are 
separated by commas (ASCII &2C), the parameters themselves being Variables (Num- 


ber or String), Strings (6128 only) and Numbers. 


NUMBERS 

The method of representing Numbers with tokens varies considerably, as some 
Numbers are wholly represented by a discrete Token while others have one of sev—- 
eral common Tokens followed by the value required in 1,2 or 5 byte form. But one 
thing to notice about all Number representations,in the Program Area at least,is 
that they are all positive — if a negative Number is required then a byte of &F5 
will precede the Token of the Number concerned which will itself be positive. 


1) INTEGERS from 0 to 9: these are wholly represented by Tokens G&0E to &17 resp- 


ectively with no following value bytes; ie to calculate the Number just subtract 
&OE (14 decimal) from the Token (eg &15 — &0E = 5) 
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2) INTEGERS from 10 to 255 decimal:these have the common Token &19 followed by a 
single byte containing the value; eg &19 &0A would be 10 decimal. This is one of 
the few times where it would be easier to use decimal format for the contents of 
the value byte to get a clear understanding of the exact correlation between the 
value of the byte and the number represented. ) 


3) INTEGERS from 256 to 32767 decimal: the common Token here is &1A followed by 

two bytes containing the Number; eg 256 decimal would be present as &1A &00 &O1, 

and 257 as SLA &01 &01. When two byte values are used by microprocessors such as 
the ZILOG Z80A used in the Amstrad the least significant byte (LSB) comes before 
the most significant byte (MSB). The value is calculated from L5B + 256 x MSB. 


A) INTEGERS which are less than ~32767, greater than 32767, or any non-integers 
(ie. those which have anything other than 0 to the right of the decimal point): 
The common Token is &1F, followed by four bytes which hold a part of the Number 
called the Mantissa and these bytes are followed by 1 byte holding another part 
of the Number called the exponent.An explanation of this five byte value format 
is very involved and really beyond the scope of this article, but I am sure the 
Editor will oblige with space in a later Issue if some of you would like one.In 
the meantime here are a few actual examples you could meet: 
. “RE ROS 200-260 260 275 10.25 
&IF &OO &O00 &00 &OO &BO = 0.5 
&IF £00 &00 &FF &7F &9O) = 65555 
RIF &O00 &O0 &O00 &00 &F1 = 65536 
&IF &OO &B0 &O0 &00 891 = 65537 
Negative floating point Numbers are never found in the Program Area but could be 
present in the Variables Area as a value of a REAL variable. Such REAL variables 
can only contain Numbers expressed in 5 byte form, so even integers from —32767 
to 32767 will also be stored in this way & not in the various formats applicable 


to the Program Area). 


NON DECIMAL NUMBERS 
BINARY NUMBERS, which we type into our programs preceded by &X have the Token 
&1B followed by 2 bytes containing the Number (converted to Hexadecimal): 
eg &X1100100110001111 gives &1B &8F &C9 
2) HEXADECIMAL NUMBERS have the next Token &1C followed by the 2 byte Number; 
eq. &FFOO would be &1C &00 FF. 


LINE NUMBERS 
By this I mean not those at the beginning of each line but those associated 
with Commands such as GOTO or GOSUB etc. Line Numbers used in this way have one 
of two Tokens allocated depending upon whether the program has been run or not. 
1) When a Program Line is typed, the Token used is &1E. which is followed by the 
Line Number itself in two byte form. This is what the BASIC Parser encounters 
the first time such a Command 15 met — 


by: 


2) At this point, the whole program is searched for the required line & on find- 
ing it, the address of the byte before this wanted line is stored in place of 
the Line Number we originally typed in. Also, the Token before these address 
bytes is changed from &1E to &1D. On encountering this Command a second time, 
the address is used straight away for the purpose intended without having to 
search the program all over again, thus making Locomotive BASIC even faster. 
There is no danger of a false address being left when the program is amended 
because all the Line Numbers are reinserted in place of addresses before any 
alterations can be implemented; ie before a line is DELETEd or ENTERed. 


However, the BASIC Operating System seems to be somewhat inconsistent in its 
treatment of all the Instructions which take Line Number parameters. It changes 
some Line Numbers to addresses but not others.For example, ELSE, GOSUB, RESUME, 
RUN and THEN are always changed; but AUTO,DELETE,EDIT and LIST aren't. 

The rest vary from one another; GOTO is usually changed, but not after an ON 
ERROR or ON <expression>; RENUM only changes Numbers that occur as actual Lines 
in the Program before renumbering - even the STEP parameter is treated in this 


way . 


NUMBERS IN DATA STATEMENTS 

Parameters after a DATA statement can be strings or numbers. An all digit entry 
without enclosing quotation marks could be a number or a string, even though 1t 
looks like a number. Evidently, it would be awkward for the ENTERing routine to 
treat all entries that look like numbers as numbers, convert them to one of the 
forms detailed above and then for the BASIC Parser to find that it was a 
after all. So each digit in a DATA parameter is present in its ASCII code form. 


MISCELLANEOUS 

1) Whenever a program line is ENTERed, a byte of &00 is added to the end of the 
line we have just typed, before it is inserted into the program; this then acts 
as an End of Line marker. 

2) Between statements in a line we type a colon as a separator. This is altered 
to a byte of &01, when the line is ENTERed. When LISTing a line, this &01 Token 
is printed as ai:' 

3) The comma and the semi-colon are both used as separators between PRINT items 

and in INPUT statements and the comma is also used between parameters with many 

Instructions; in all such cases these will appear as their ASCII codes (&2C and 

&3B respectively) 

4) The SPACE character (eg after Commands with following numbers) appears as its 
ASCII (&20), although some spaces are deleted as superfluous on ENTERing a line; 
eg that after the Line Number at the start of a line. The LISTing routine prints 
a space after the Line Number automatically. If we type in two spaces after the 

Line Number then the first one is deleted but the second is still present & will 
be printed as a second space. 

5) Quotation Marks (") are used to delimit Strings & appear as their ASCII (&22). 
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6) Opening and closing Brackets & the Hash —- (,),# — are used in connection 

with numbers and the brackets also with Functions and these three also appear as 
their ASCII codes (&28, &29 and &23 respectively)... 

7) The Amstrad has 256 printable characters and in theory any of them may occur 

after a 'REM' or ''' (short REM), and any. except for the Quotation Mark itself 

(which would end a String anyway) may occur inside Quotation Marks, each as its 

ASCII code. However, the NUL character (ASCII &00), as well as being impossible 

to copy, would throw a spanner in the works of the LISTing routine if it occur— 

red under these circumstances, and thus resulting in apparently shortened lines 

and sometimes strange Line Numbers. Any line, containing such a NUL, brought to 

the screen with EDIT and then re-ENTERed will be permanently shortened. Any line 
with three consecutive NUL's will cause the Program to END at the NUL's. This is 
because the Parser takes the first 'NUL' to be the end of a line, and checks the 
following two bytes to see if they are a valid line length for the next line; a 

'length' of &0000 signals the end of the Program (no matter how much longer the 

Program actually is) and the Parser then returns control to Direct Command Mode 

with the usual ‘Ready’ message. However bytes of &00 can occur ina line (eg as 

a Variable distance or as Number value bytes) without having these effects. 


Any formatting characters used with DEC$ or with the USING qualifier for PRINT, 
will also appear as their normal ASCII's since they too are enclosed by quotes. 
In a DATA statement, in the case of delimited strings the above applies. 
However if quotation marks are not used, then, with the exception of the quotes 
character again, only those characters between [SPACE] and the shaded character 
with ASCII code &7F or 127 decimal may be used.Any Control Code characters with 
ASCII's below &20 that are typed in will be replaced with spaces, and any char- 
acters with codes above &7F will be deleted. 


As any bytes found in a Program line could be a Token or part of a distance, 


address, value or name they need to be interpreted in the context of the line & 
not taken at their immediate face value. 


I hope that these gleanings will be of help and interest to you and give you 
a clearer insight into the workings of our excellent computers.I only wish that 
someone else had published them at the introduction of the CPCs & saved me some 
of the time I have spent; it's not as though there's something Top Secret about 
them but the makers of Arnold have played their hands very close to their chests 
and such information is not easy to come by. On the other hand, I must admit to 
having enjoyed the effort of finding out some of the foibles and secrets of the 
Amstrad.In the next issue of PRINT-OUT, I'll be presenting an RSX (based on the 
information presented here) that can be used to find occurrences of any part of 
BASIC in a program. 
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TOKENS TABLES 


00 End of Line marker 


0} 
02 
03 
04 


: (Statement separator) 


% variable (Integer) 


$ variable (String) 
' variable (Real) 


05 to OA NOT USED 


DEFINT variable 

DEPSTR variable 

DEFREAL or undefined variable 
Q (number) 

1 (integer nunbers) 


ca woh on om ao mo 


. g 7] i 


25 
3B 


ROT USED 
10 to 255 integer numbers (the 
value contained in the next byte) 


| 256 to 32767 integer numbers (the 


value contained in the next tyo 
bytes) 

&X (binary numbers; value is held 
in the next two bytes] 

& (hexadecinal numbers; value 
contained in the next tvo bytes) 
Progran Line Number {converted to 
the ‘address' before the start of 
the line & contained in the next 
two bytes; found when this part of 
the progran has already been run] 
Progran Line No. (still as a Line 
No since this part of the progran 
has not yet been run; value cont- 
ained in the next two bytes] 
integers less than -32767 or 
greater than 32767, and floating 
point numbers (the value is held 
im the next 5 bytes} 

Space - used as separator between 
parts of a statenent 

NOT USED 

Quotation mark '"' is used to de- 
linit a string 

Hash '#' for Kindows and Streans 
to 27 NOT USED 

opening bracket '(’ 

closing bracket '}’ 

to 2B NOT USED 

conna ',' used as a separator in 
PRINT ites & between paraneters 
Hyphen '~’ used with DEFINT etc 
to 3A NOT USED 
Seni-colon ';’ is used aS a sep- 
arator for Print items etc 


3C to 7B NOT USED 
7C,00 | (symbol that precedes an RSX 


connand, The £00 byte is inserted 
when the program is stored & will 


not appear on listing the progran) 
to 7F ROT USED 


EDIT 


01,97 ELSE {the &01 byte is inserted 


in the progran when stored & will 


not appear when listed) 


GOSUB or GO SUB 
GOTO or GO TO 


KERGE 
KID$ (Command, and Function but 
without preceding GFF byte) 


OH BREAK 

OH ERROR GOTO 0/0N ERROR GO TO 0 
ON OQ 

OPERIN 

OPEXOUT 

ORIGIN 


PRINT 


01,C0 ' (abbreviated version of REH; 


os 03 3 SS Ey Ba GS Gg St be Sy ee 


see note with ELSE Re &01 byte) 
RAD 

RANDOMIZE 

READ 

RELEASE 

REM (written in full] 


NOT USED 

ERL (Function only; no preceding 
bFF byte) 

PR (Command when used with DEF 
Token and SPACE, and Function but 
without preceding &FF byte) 

aPC 

STEP 

OWAP 

to E9 KOT USED 

TAB 

THEN 


NOT 
Function prefix (see Table 2} 


The CPC 464 does not have certain of 
the above Commands. They are indicat- 
ed by a '*' nor does it have certain 
combined coppands, eg:- CLEAR INPUT, 
GRAPHICS PEW, GRAPHICS PAPER. It does 
however have HID$ as an undocunented 
command. The 464 also does not have 

the tyo functions DERR and COPYCHRS. 
It also does not perforn DECS, even 

though it recognises the furction. 


Functions (preceded by éFP' 
00 ABS 45 BND 
QOL ACS 46 TIKE 
2 ATK 47 XPOS 
03 CHRS 48 YPOS 
04 CINT 49 DERR ' 
05 cds 4h to 70 NOT USED 
06 CREAL | 7] BIKS 
7 EXP 72 DECS é 
08 FIX 3 HEX$ 
09 FRE 74 INSTR 
OA INKEY | 75 LEFTS 
OB INP 76 HAR 
OC INT 77 KIN 
OD JOY 78 POS 
OE LEX 79 RIGHTS 
OF LOG 7h ROUXD 
10 LOGO) | 7B STRINGS 
11 LOWERS | 7C TEST 
12 PEEK 7D TESTR 
13 RERAIN | 7E COPYCHRS * 
14 SGR TF VPQS 
15 SIN 80 to FF ROT USED 
16 SPACES 
17 5 
18 SOR 
19 STRS 
1A TAN 
1B ONT 
1C UPPERS 
1D VAL 
1E to 3F WOT USED 
40 EOF 
41 ERR 
42 HIKE 
43 INKEY$ 
44 PI 


for this is that binary involves only ones and zeros which in turn are recorded 
by the computer as being either 'on' or ‘off’. Each digit in binary is calleda 
BIT and eight digits form a BYTE. Thus an 8-bit number has eight digits (each of 
which can be either 1 or @) and a 16-bit number has 16 digits. 

The lowest value that a standard S-bit number can hold is zero (when all of 
the bits are set to zero — ie @@@G@@0@@) and the highest value is 255 (when they 
are all set to ome -— ie 11111111). Likewise a 16-bit number can have a value of 
between @ and 65535. The reasons for this were explained in the very first issue 
Of Prant-Out. 

However there's one very serious problem with this system; how can the CPC 
store negative numbers? A lot of the time this problem can be avoided but there 
are certain occasions when it is essential to to represent negative numbers and 
so ‘Two's Complement' or the ‘signed number system' was devised. 

Two's Complement still uses the binary counting system in exactly the same 
way as before -— it is just the way in which the digits are interpreted that has 
changed. When using 2's Complement it's only possible to represent numbers from 
~128 to 127 in an 8-bit binary number. To work out what the negative number is, 
the following rules must be followed: 


First, write out the positive number in binary form:- 


eq. 1905 = Q@11@1001 

Then change all of the zeros to ones and all the ones to zeros:- 
eg. 19@1@119 

And finally, add i to this. This gives the negative form:- 
eg. —-105 = 1O@1O111 


An important point to remember, when using this method, is that the binary 
number must always contain eight digits. As proof that the system actually does 
work, we will add -1@5 to +1@5 and see if the answer is correct (ie. zero) 


“105 = 10@10111 
PLUS 105 = Q11@1@@1 
EQUALS @ = 1 QOOOGOOE 


There's something not quite right about this answer until you remember that 
an 8-bit, signed number must contain only eight digits. Therefore, the left-—most 
digit can be discarded thus giving 90000000 which is the correct result. Numbers 
which have been produced using 2's complement are known as ‘signed’ numbers, and 
those that have not are called ‘unsigned’ numbers. 
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When dealing with signed numbers, a quick way of telling if it is positive 
or negative is to look at the left-most digit. If it is a 1, the number is neg- 
ative, otherwise it is positive. ‘ 


Here is a brief summary of the differences between signed and unsigned numbers: 
9-BIT SIGNED NUMBERS can represent both positive and negative numbers and 
range from -128 (equals 19000000 in binary) to 127 (equals @11iliiil). 
9-BIT UNSIGNED NUMBERS can represent only positive numbers and range from 
@ (equals 90000000 in binary) to 255 (equals 11111111). 
The same rules, methods of conversion and differences apply to 16-bit numbers; 
the only change is that there must be 16 digits in the binary number and that 
numbers from between ~—32769 and 32767 can be represented when it is in signed 
form, and between @ and 65535 in its unsigned form. 


There's only one problem remaining; how does the computer know when a number 
is signed or unsigned. The answer is that it depends on what type of number it 
is expecting.For example, in last issue's Machine Code, there was a program to 
draw lines using relative coordinates. Negative numbers had to be given to the 
PC and these were represented as 16-bit signed numbers. As the screen is only 
64@ pixels wide by 4@@ pixels high, the computer knows that we are unlikely to 
want to draw to a place about 6500@ pixels along, and so treats it as a signed 
number, thus meaning about -4@@ pixels — far more sensible when using relative 
coordinates. This might not seem much help, but do not worry — the CPC 1s very 
good at getting it right [1! 


As a conclusion to this article. here's a short program which asks for an 
8-bit number (in either decimal,binary or hexadecimal form) and then works out 
what the negative version of this number is. If you enter numbers greater than 
255, it's likely to give results which you may not expect. Binary numbers must 
be preceded by &X and hexadecimal numbers by the ‘&' sign. The program expects 
you to enter a positive 
number & will then give 


REM Two’s Complement Converter 
2@ MODE 2:INPUT "Enter the number: '",nums 
40 a$=BINS (VAL (nums) , &) 

S@ PRINT "The Binary number is ";a$ 

6@ FOR i=1 TO 8 

7@ t$=MID$(as,i,1? 

8@ IF t$="1" THEN dig$="@" ELSE dig$="1" 
90 r$=r$+digs 

100 NEXT 1 

11Q rS="&K"+r$ 

120 c=(VAL (r$)+1) 

130 com$=BIN$(c,8) 

14@ PRINT "The complement is: "53;com$ 


you the negative equiv- 
alent. However, rather 
interesting and unusual 
results can be obtained 
by entering a negative 


number to begin with. 


Whilst signed numbers & 
2's complement may seem 
complicated, all of the 
difficulties can easily 
be overcome by use of a 
good assembler, such as 
the one on this issue's 
program tape or disc!!! 


Prizes to be Wau ff 


As this is our birthday issue, we have decided to run a competition to celebrate 
and have managed to get hold of some wonderful prizes. You may remember that in 
our last issue we reviewed a copy of Tearaway from CPC Network and it was highly 
recommended. Tearaway is the ultimate hacking program - it installs itself ina 
Multiface Two and at a touch of the red button you have a fully fledged monitor, 
Gisassembler and a host of other features all at your fingertips. Don't worry if 
you have not got the necessary set-up to use Tearaway. we have got a set of dust 
covers (please tell us which computer you have) amd a copy of ‘Rick Dangerous @' 
Oo give away. In order to have more chances to win, you choose to go for as many 
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of these prizes as you like. First. you have ta decide on the correct answer for 
each of these questions, then just complete the box at the bottom of the page: 
1. Amstrad’s newly released console is called the... 

a) GxXAGO b) GxX4A0e@ c) XG40@0 
2. The new Pluses and Console beth use the same central processor. Is it. 

a) 6582 b) 6888@ c) 282 
3. The piece of cartridge software supplied with the new machines 1s. 


Oo 
a} Fire and Forget II b) Batman — The Movie c) Burnin’ Rubber 


4. In which major European city were Amstrad'’s three new computers launched.... 
a} Paris b) London c) Berlin 


Ci 


Who is Amstrad's Technical Manager — he also helped design the original CPC... 


a) Alan Sugar bb) Keith Patterson ec}. Roland Perry 


Just ring the correct answers, amd then tick which prizes you could receive (the 
more you tick the more your chances cf winning:). Finally. fill in your name ar 
nm send your Ne aig: enury Go WS aL. Prinv-Oal.. o-Maze Greer Road. 


ortford, Hertfordshire CM23 2FJ. 


ah 


t 
address. The 
BaAshiop: Soc 


Name eee Cee ee eee ae I'd like to win (tick as many as you want): 
PGOUOSES 2 ol okie wah Wee shee hw eee : 

Se hpt reese ide ede a namep e Mecha tel sth dh ee rua eines TEARAWAY (6128 and Multiface only) 

Ne Sse Tay te ig Nas ey sao ae ce ee Deca oa be Ta Ge ee ie DUST COVERS for the 464/6128/Colour/Mono 
POSUCCUe. Bs Git ik eth ea eee A diteia we G RICK DANGEROUS II (on tape) 


TO INCREASE YOUR CHANCES OF YOU WINNING A PRIZE WHY DON'T YOU SEND US 
THE COMPLETED QUESTIONNAIRE OVERLEAF AT THE SAME TIME 
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PRIZE QUESTIONNAIRE 


In Issue One, we included a prize questionnaire so that we could find out 
what sort of things people wanted from the magazine. Times change and a year in 
computing is a long time, so we thought that it would be an idea to run another 
questionnaire to discover what our readers want in the next year. To provide an 
incentive for sending in your questionnaire, we're going to give away a capy of 


PROT EXT (tape) 


to the first person whose questionnaire is drawn from the hat. So, remember to 
write your own name and address clearly on the back of this sheet. The address 
for all questionnaires is PRINT-OUT,8 Maze Green Road,Bishop's Stortford,Herts. 


1. Which pieces of hardware (including computer) do you own 


2. Wheat program/game do you use the most frequently 7 
Which area(s) of Print-Out interest you most ? 
4, Which area(s) of Print-Out interest you least ? 
5. Do you want more, less or the same of the following articles ? 


BASIC Programming MORE DAME cae 
M/Code Programming MORE SAME ale 
Homebrew Reviews MORE Di LESS 
Public Domain MORE SAME LESS 
Using CPM MORE SAME LESS 
Solutions to problems MORE SAME aye) 
News and General MORE DAME LESS 
Type in programs MORE SAME LESS 


6. Do you find the articles too technical/too simple/about right ? 


“-y 
€ 


“I 


What article(s) would you like to see in future issues of Print—-Out 


What do you feel about Amstrad's new computers and why ? 


se) 


If vou have any further comments please feel free to write them on another piece 
of paper. Remember, what you think and want is very important. 
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Offers 


Please make all cheques payable 
to Print-Out but any postal orders 
should be made out to T J Defoe as 
this saves the Post Office a great 
deal of time and effort. Unless it 
cannot be avoided, it is advisable 
not to send cash through the post. 
All orders should be sent to :— PRINT-OUT. Special Offers, 8 Maze Green Road, 


Bishop's Stortford, Hertfordshire CM23 2PJ. 


If you wish to order a copy of Issue Eight in advance you may do so by sending 
a cheque / postal order for £1.10 (cr 70p + an A4 SAE with a 28p stamp) to the 
usual address. We hope to have it published by about the 30th November, and ait 
will be forwarded to you as soon as it is available. You may also order a copy 


of the program cassette or disc in advance by sending the correct amount. 


PROGRAM TAPES AND DISsts 


We supply beth program tapes and discs for all the issues and the prices given 
below also include a booklet to explain how the programs work plus postage and 
packing. Tapes and discs are available for Issues One, Two, Three, Four, Five, 
Six and Seven. The cost for the program tapes are:— 
a) A blank tape (at least 15 minutes) and 50p (p+p) 
oy b) £1.00 (which also includes the price of a tape) 
And the cost for a program disc is :- 
a) A blank formatted disc and 50p (p+p) 
or b) £3.00 (which also includes the cost of a MAKXELL/AMSOFT disc) * 


BACK CUPIES 


We still have a supply of Issues One, Two, Three, Four, Five and Six available 
and the price is £1.10 which includes postage and packing. Alternatively. you 
can order both a back issue and its corresponding tape or disc by sending:- 
@) £1.75 —- includes the tape, the required issue and postage and packing 
b) £3.75 -— includes the disc (genuine MAXELL/AMSOFT disc) * and also the 
required issue and postage 


* When ordering using this particular method please allow about 21 days for 
delivery as we must rely on outside suppliers for the discs. 

* Please also note that one side of one CF-2 disc will hold all the programs 
from upto six issues. Therefore, the cost is £3.00 for a disc plus one set 
of programs and then 50p for each additional issue thereafter. 
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